為什麼會想寫這篇文章呢? 主要是因為我發現,現在還是有不少人在使用免費版的 AI 工具;同時,許多企業也正嘗試在雲端環境(例如透過 Microsoft Foundry)部署專屬的高階模型,卻往往卡在不知道如何設定,或部署完後不知道該如何串接到實際的工具中使用。
前置準備
五步驟完成部署與串接
Step 1|建立 Azure 訂閱
登入 Azure Portal → 搜尋「Subscriptions」→ 新增訂閱,初學者選「Free Trial」,企業選「Pay-As-You-Go」。
Step 2|在 AI Foundry 建立 Agent
進入 Microsoft AI Foundry → 點擊「Create an agent」→ 設定 Project 並建立 Resource Group(底層資源一次搞定)。
Step 3|部署 GPT-4.1 模型
Agent 建立後選「Deploy a model」→ 搜尋 GPT-4.1 → 自訂部署名稱(建議取好記的,如 gpt-4.1)→ 設定 TPM(Tokens Per Minute)→ 點擊 Deploy,等幾分鐘即完成。
Step 4|取得 Endpoint 與 API Key
前往 AI Foundry 左側 Overview → 取得 Endpoint(格式應為 https://your-resource.openai.azure.com/)與 API Key。
⚠️ 注意:若 URL 帶有 /openai/deployments/... 長串後綴,串接時只保留到 .com/,否則會 404。
Step 5|編輯 config.toml 完成串接
找到設定檔 %UserProfile%.codex\config.toml,填入以下設定:
tomlmodel = "gpt-4.1"
model_provider = "azure"
model_reasoning_effort = "medium"
[model_providers.azure]
name = "Azure OpenAI"
base_url = "https://YOUR_RESOURCE_NAME.openai.azure.com/openai/v1"
env_key = "AZURE_OPENAI_API_KEY"
wire_api = "responses"
API Key 透過環境變數注入(Windows PowerShell):
powershell[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'YOUR_KEY', 'User')
設定完記得重啟終端機讓環境變數生效。
驗證成功
在 Codex 下指令:「請確認你的身分與模型版本?」,若有正常回應,代表企業級模型部署與串接完成!
感謝閱讀,為了方便日後系統化檢索,我將技術筆記同步收錄在個人知識基地,有更完整的目錄索引與詳細內容。愷的大冒險 Kai's Adventure